home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / comm / erp.lha / ERP.doc < prev   
Text File  |  1995-07-26  |  6KB  |  164 lines
  1. EasyRequestPatch V1.0 by Chris Hodges
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. Introduction
  5. ~~~~~~~~~~~~
  6. A friend of mine once asked me, if I could write a little program for
  7. his BBS that would cancel all the system-requesters that may appear,
  8. as his harddisk brought up read/write errors which were not really
  9. existant.
  10.  
  11. So this is my first attempt for such a patch. I thought somebody had
  12. already invented a program like this, but none of the asked sysops
  13. could help.
  14.  
  15. The patch will kill any requester that matches a pattern given in a
  16. config file. Other requesters will not be harmed at all.
  17.  
  18. I tried to make this program as secure and efficient as possible, and
  19. I think this program is.
  20.  
  21. Requirements
  22. ~~~~~~~~~~~~
  23. EasyRequestPatch needs Kick 2.04 or higher.
  24.  
  25. Usage
  26. ~~~~~
  27. Run >NIL: ERP >>logfile [configfile] [QUIT]
  28.  
  29. As you can see, the program does not unhook itself. The config file
  30. must be specified if you install the patch, to remove the patch
  31. again, ERP QUIT is sufficient. All normal cli output can be
  32. redirected into a log file.
  33.  
  34. Configuration
  35. ~~~~~~~~~~~~~
  36. An example configuration file has been included in the archive.
  37.  
  38. The configuration file is a normal AmigaDOS ascii-text. It may *NOT*
  39. contain other line seperators than linefeeds (no CRs allowed!).
  40.  
  41. Empty lines and characters after a semicolon are ignored.
  42.  
  43. A configuration line looks like this:
  44.  
  45. pattern,(delay,gadgetnum,retries)
  46. or
  47. pattern,(delay,gadgetnum,retries),(delay,gadgetnum,retries),... etc.
  48.  
  49. The pattern string may contain any normal dos jokers. Use quotemarks
  50. where required. After the pattern you have to enter at least one
  51. group containing three defining values. You can define up to five
  52. such groups. delay is used to specify the time to pass before ERP
  53. answers the requester with the given gadget number. These delays
  54. have to be entered in units of 1/50 secs.
  55.  
  56. This action will be repeated until the requester shuts up or the
  57. number of retries has been overridden. If this happens, the next
  58. group will be taken for the requester, or if it already has been the
  59. last group, the requester will pop up as usually.
  60.  
  61. The gadgets in each requester are placed in ascending order from 1 to
  62. N-1, whereas N represents the total amount of gadgets in the dialogue
  63. box. The last gadget (often 'Cancel') is always gadget number 0.
  64.  
  65. There are few 'special' gadgetnumbers:
  66.  
  67. -1: Is used to behave as if an IDCMP event has occurred (often this
  68.     has the same result as clicking on the 'Retry' gadget.
  69.  
  70. -2: Just waits the amount of time you give with the delay
  71.     instruction.
  72.  
  73. -3: Flashes the display and beeps.
  74.  
  75. -4: Resets the computer after the given delay. Please note that this
  76.     delay should be at least 5 seconds (=250 VBLs), to ensure that
  77.     all disk activity has been stopped.
  78.  
  79. -5: Like -4, but kills the exec base to avoid a guru meditation on
  80.     bootup.
  81.  
  82. Note that the patterns are proccessed in that order they have been
  83. entered into. There can be as many pattern definitions as you like.
  84.  
  85. Notes
  86. ~~~~~
  87. Due to the dynamic linked lists used in this program, it could happen
  88. that this program fragementates your memory. Therefore I use reversed
  89. memory allocation to avoid little scattered memory blocks.
  90.  
  91. These linked lists are required to distinguish between different
  92. requester coming from different tasks. As there is no possibility to
  93. check whether a requester has been killed successfully (i.e the
  94. program is satisfied with the result and does not opens the requester
  95. again), the program reserves some memory to save some information
  96. about the requester. If the same requester appears within two seconds
  97. ERP acts according to the group behaviour. Otherwise the memory is
  98. freed and the old requester will be forgotten.
  99.  
  100. History
  101. ~~~~~~~
  102. V1.0 (26-Jul-95):
  103. ~~~~~~~~~~~~~~~~~
  104. - The logfile was a little bit faulty due to the mixed usage of
  105.   buffered and non-buffered writing. This has been fixed now.
  106. - Changed the main loop quantum from 1 VBL delay to 10 VBLs. This
  107.   will reduce the cpu usage.
  108. - Changed the requester-timeout to two seconds instead of one.
  109. - Modified the parser to check for more errors.
  110. - Increased the general buffers a bit.
  111. - Strange things seem to happen: The last program opening a
  112.   requester, will get the control-c signal passed through. No clue
  113.   why this happens and how to prevent it. Please use 'ERP Quit'
  114.   instead of the Ctrl-C key.
  115. - Added the wait and reset events.
  116. - Added the beep and hard reset events.
  117.  
  118. V1.0ß (25-Jul-95):
  119. ~~~~~~~~~~~~~~~~~~
  120. - First release. Works quite well.
  121.  
  122. Copyright notice
  123. ~~~~~~~~~~~~~~~~
  124. EasyRequestPatch (ERP) and it's documentation are Copyright © 1995
  125. by Chris Hodges. All rights reserved.
  126.  
  127. Disclaimer
  128. ~~~~~~~~~~
  129. EasyRequestPatch has proven to be stable in everyday use. The author
  130. is not responsible for any loss of data, damages to software or
  131. hardware that may result directly or indirectly from the use of this
  132. program. The author reserves the right to make changes to the
  133. software or documentation without notice.
  134.  
  135. Shareware note
  136. ~~~~~~~~~~~~~~
  137.  
  138. This program is shareware, this means that you can copy it freely as
  139. long as you don't ask any more money for it than a nominal fee for
  140. copying. If you want to distribute this program you must keep this
  141. document with it. This program cannot be used for commercial purposes
  142. without written permission from the author.
  143.  
  144. None of the files of the ERP package may be modified or left out
  145. without permission of the author. Crunching or archiving is allowed
  146. only if none of the ERP files get modified by it. Adding BBS adverts
  147. or similar to such an archive is forbidden.
  148.  
  149. If you use this program regularily, the author would appreciate any
  150. donation you could give him. Especially SysOps could register this
  151. program, as they really may need ERP for his BBS.
  152.  
  153. Contact address
  154. ~~~~~~~~~~~~~~~
  155. Any mails or donations to:
  156.  
  157. Chris Hodges                    Account: 359 68 63
  158. Kennedystr. 8                   BLZ    : 700 530 70
  159. D-82178 Puchheim                Bank   : Sparkasse Fürstenfeldbruck
  160. Germany
  161. Tel.: 089/8005856
  162. Email: chris@sixpack.pfalz.org 
  163.  
  164.